<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Chapter 9.  Dbstl Iterator Classes</title>
    <link rel="stylesheet" href="apiReference.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB C++ Standard Template Library API Reference" />
    <link rel="up" href="index.html" title="Berkeley DB C++ Standard Template Library API Reference" />
    <link rel="prev" href="stldb_multisetoperator_ueq.html" title="operator!=" />
    <link rel="next" href="db_base_iterator.html" title="Chapter 10.  Db_base_iterator" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 11.2.5.3</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Chapter 9. 
 Dbstl Iterator Classes  </th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="stldb_multisetoperator_ueq.html">Prev</a> </td>
          <th width="60%" align="center"> </th>
          <td width="20%" align="right"> <a accesskey="n" href="db_base_iterator.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="chapter" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title"><a id="dbstl_iterators"></a>Chapter 9. 
 Dbstl Iterator Classes  </h2>
          </div>
        </div>
      </div>
      <p>Common information for all dbstl iterators:. </p>
      <p>1. Each instance of a dbstl iterator uniquely owns a Berkeley DB cursor, so that the key/data pair it currently sits on is always valid before it moves elsewhere. It also caches the current key/data pair values in order for member functions like operator* /operator-&gt; to work properly, but caching is not compatible with standard C++ Stl behavior --- the C++ standard requires the iterator refer to a shared piece of memory where the data is stored, thus two iterators of the same container sitting on the same element should point to the same memory location, which is false for dbstl iterators.</p>
      <p>2. There are some functions common to each child class of this class which have identical behaviors, so we will document them here.</p>
      <p>This class is the base class for all dbstl iterators, there is no much to say about this class itself, and users are not supposed to directly use this class at all. So we will talk about some common functions of dbstl iterators in this section.</p>
      <p></p>
      <h4><a id="idp50665784"></a>
See Also
</h4>
      <p> </p>
      <p><a class="link" href="db_vector_base_iterator.html" title="Chapter 12.  Db_vector_base_iterator">db_vector_base_iterator</a>
 <a class="link" href="db_vector_iterator.html" title="Chapter 13.  Db_vector_iterator">db_vector_iterator</a>
 <a class="link" href="db_map_base_iterator.html" title="Chapter 15.  Db_map_base_iterator">db_map_base_iterator</a>
 <a class="link" href="db_map_iterator.html" title="Chapter 16.  Db_map_iterator">db_map_iterator</a>
 <a class="link" href="db_set_base_iterator.html" title="Chapter 18.  Db_set_base_iterator">db_set_base_iterator</a>
 <a class="link" href="db_set_iterator.html" title="Chapter 19.  Db_set_iterator">db_set_iterator</a>
 </p>
      <h4><a id="idp50279080"></a> Public Members </h4>
      <div class="informaltable">
        <table border="1" width="80%">
          <colgroup>
            <col />
            <col />
          </colgroup>
          <thead>
            <tr>
              <th>Member</th>
              <th>Description</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td>
<a class="link" href="db_base_iterator.html" title="Chapter 10.  Db_base_iterator">
db_base_iterator</a>
</td>
              <td>
db_base_iterator</td>
            </tr>
            <tr>
              <td>
<a class="link" href="db_reverse_iterator.html" title="Chapter 20.  Db_reverse_iterator">
db_reverse_iterator</a>
</td>
              <td>
db_reverse_iterator</td>
            </tr>
            <tr>
              <td>
<a class="link" href="db_map_iterator.html" title="Chapter 16.  Db_map_iterator">
db_map_iterator</a>
</td>
              <td>
db_map_iterator</td>
            </tr>
            <tr>
              <td>
<a class="link" href="db_map_iterators.html" title="Chapter 14.  Iterator Classes for db_map and db_multimap">
Iterator classes for db_map and db_multimap.</a>
</td>
              <td>
Iterator classes for db_map and db_multimap.</td>
            </tr>
            <tr>
              <td>
<a class="link" href="dbset_iterators.html" title="Chapter 17.  Iterator Classes for db_set and db_multiset">
Iterator classes for db_set and db_multiset.</a>
</td>
              <td>
Iterator classes for db_set and db_multiset.</td>
            </tr>
            <tr>
              <td>
<a class="link" href="db_vector_iterators.html" title="Chapter 11.  Iterator Classes for db_vector">
Iterator classes for db_vector.</a>
</td>
              <td>
Iterator classes for db_vector.</td>
            </tr>
          </tbody>
        </table>
      </div>
      <h4><a id="idp50798888"></a>
Group</h4>
      <p>
None</p>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="stldb_multisetoperator_ueq.html">Prev</a> </td>
          <td width="20%" align="center"> </td>
          <td width="40%" align="right"> <a accesskey="n" href="db_base_iterator.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">operator!= </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Chapter 10. 
 Db_base_iterator  </td>
        </tr>
      </table>
    </div>
  </body>
</html>
